home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / telecomm / stadel / stadel1.zoo / runtime / citadel.man next >
Encoding:
Text File  |  1988-09-20  |  7.9 KB  |  185 lines
  1. STADEL(1)                            STADEL(1)
  2.  
  3.     Name
  4.     STadel -- a BBS for the Atari ST and IBM PC.
  5.  
  6.     Syntax
  7.     citadel [+multi] [+netlog] [+netdebug] [+hup] [+line] [+zap]
  8.     configur [x]
  9.     configur [+ [option=setting] [...]]
  10.     makezt
  11.  
  12.     Description
  13.  
  14.     Note:  STadel is not* free software nor is it in the public
  15.     domain! It is a copyrighted work protected to the full extent
  16.     of US and international copyright law.
  17.  
  18.     STadel is a room-structured message system.  The fundamental
  19.     design goal is to provide a congenial forum conducive to
  20.     interesting discussions.  The software is intended to be as
  21.     unobtrusive, unintrusive and unconstraining as possible. In
  22.     software as elsewhere, good engineering is whatever gets the
  23.     job done without calling attention to itself.
  24.  
  25.     The fundamental design metaphor is that of a building
  26.     consisting of a series of independent rooms, each of which
  27.     hosts a discussion devoted to a particular topic.  Messages
  28.     are stored and retrieved in chronological order within each
  29.     room.  Messages are formatted to the caller's screen width.
  30.  
  31.     Callers may travel freely between the rooms, reading old
  32.     messages and posting new ones.  New rooms may be created at
  33.     will, and old ones are deleted when they empty of messages.
  34.  
  35.     People familiar with other electronic message systems may
  36.     wish to compare STadel rooms with EIES conferences, Arpanet
  37.     mailing lists, Usenet newsgroups, individual "linear" BB
  38.     systems or whatever;  the parallels are not exact but the
  39.     functions are similar.
  40.  
  41.     The fundamental Goto, Read and Enter commands have been
  42.     streamlined as much as possible.  The message display format
  43.     has a minimum of unnecessary noise:  the topic is implicit
  44.     in the message's location within a room, no explicit TO
  45.     field is present, no message ID # is printed, no redundant
  46.     "END OF MESSAGE" blurbs etc.  The most common Goto, Read and
  47.     Enter commands are all single-key.  STadel automatically
  48.     skips rooms which have no new messages, and old messages in
  49.     the current room.  (Less concise commands are of course
  50.     available to override this.)
  51.  
  52.     Citadel Version 1 offered no more than the above, and was
  53.     quite well recieved.  Version 2 left the basic structure
  54.     unchanged, but added some additional peripheral capabilities.
  55.     Private person- to-person mail is now supported.  Private
  56.     rooms can host restricted conferences.  Once visited,
  57.     private rooms behave exactly like regular rooms to the
  58.     participants, but they are not accessable to others who don't
  59.     know the name of the room. The sysop can set up some rooms
  60.     to be windows onto designated directories.  These directory
  61.     rooms support the usual message functions, but also allow
  62.     one to to do directory listings by wildcard match, or to
  63.     upload and download files via Xmodem or  Ymodem. Various
  64.     rough edges have been smoothed off.  The message code has
  65.     been reworked to support automatic networking of Citadel
  66.     nodes.
  67.  
  68.     STadel is written in Alycon C. The distributed system can be
  69.     installed and run without recompilation in most cases.
  70.     STadel needs an Atari ST and an auto-answer modem.
  71.  
  72.     The PC version of STadel is written in Microsoft C.  It
  73.     needs a true PC compatable with 256K memory and an auto-
  74.     answer modem.
  75.  
  76.     The source files run to about 600K, the executables about
  77.     250K. In a functioning system, the room and userlog files
  78.     together take about 150K, and one would normally like about
  79.     200K for message text, to keep the wraparound time longer
  80.     than a week.
  81.  
  82.     Here are what the commandline options do:
  83.  
  84.         +multi    - for running STadel in the background.
  85.               if you specify +multi, STadel will not
  86.               do i/o to the system console (Atari ST
  87.               only.)
  88.         +hup    - leave DTR enabled at all times.  STadel
  89.               normally drops DTR whenever you put the
  90.               system into console mode and when it exits.
  91.         +netlog    - keep a log of all networking activity in the
  92.               file netlog.sys in your #auditdir.  (If you
  93.               don't have a #auditdir, it will be placed
  94.               in your #homedir)
  95.         +netdebug    - for debugging the network.  You will probably
  96.               never need to use this option.
  97.         +line       - uses the bottom line of the screen as a status
  98.               bar to take the place of the usual `(name)'
  99.               printout before each room prompt.  This status
  100.               line will hold the caller name and the baudrate
  101.               that s/he is calling at (Atari ST only.)
  102.         +zap    - Activate the duplicate-message zapper. If this
  103.               option is active, STadel will maintain a file
  104.               -- ctdlloop.zap in the #netdir -- that contains
  105.               entries for the newest message received from
  106.               each system on the net for each room.  When
  107.               running the loopzapper, STadel checks the date
  108.               on every inbound network message -- if a
  109.               message was posted earlier than the newest
  110.               message received by the system, it will be
  111.               discarded.
  112.  
  113.  
  114.     Configur is the configuration program for citadel.  Citadel
  115.     gets/store its system variables in a file called ctdltabl.sys,
  116.     which is generated by configur. When you first create your
  117.     system, you modify your copy of ctdlcnfg.sys, then run
  118.     configur to create ctdltabl.sys.  Then whenever you modify
  119.     the system, you rerun configur to update ctdltabl.sys. (If
  120.     you are running with the loopzapper active, you may need to
  121.     run makezt as well.)
  122.  
  123.     Like citadel, configur has several options; if you just run
  124.     `configur' without specifying any parameters, it will create
  125.     system files and ask you whether you want to reinitialise
  126.     files that are already there. If you do `configur + [options]',
  127.     it will update the existing ctdltabl.sys without* scanning
  128.     the existing system files.  `configur + download=200' will
  129.     set the system download limit to 200K quickly and without
  130.     muss or bother (if you don't set any options, configur will
  131.     just rescan ctdlcnfg.sys.)  `configur x' is the third way to
  132.     reconfigure the system -- and it's the way that configur is
  133.     usually invoked after a system crash.  If you do `configur x',
  134.     configur will not ask you if you want to reinitialise the
  135.     system files and it will fail if it cannot find all of the
  136.     system files.
  137.  
  138.  
  139.     Makezt reinitializes the loopzapper file ctdlloop.zap.  It
  140.     scans through ctdlmsg.sys and builds ctdlloop.zap and an
  141.     internal hash table in ctdltabl.sys.  If you are running
  142.     with +zap, you must run makezt if you lose your system table
  143.     and have to rebuild it with configur.
  144.     
  145.  
  146.     Differences between the Atari ST and IBM PC versions of STadel
  147.  
  148.     STadel on both machines is essentially the same. The PC
  149.     version does not have the `+line' or `+multi' flags, nor does
  150.     it allow you to use ^Z to detach the process.  The PC version
  151.     allows you to attach the BBS to either COM1: or COM2: -- the
  152.     ST version is restricted to the serial port.
  153.  
  154.     And the PC version is significantly slower in [c]hat mode.
  155.     The ST version of STadel will allow you to use it as a modem
  156.     program at speeds up to 19200 baud; the PC version (on a 4.77mh
  157.     Epson Equity 1) barely handles 2400 baud.
  158.  
  159.     Author
  160.     A cast of thousands.  STadel is derived from Citadel, which
  161.     was created in Seattle, WA, in 1981 by CrT.  Its immediate
  162.     predecessor is Citadel-86, which was ported from Citadel by
  163.     Hue, Jr. of Minneapolis, MN, in late 1984.  STadel was
  164.     ported to the Atari ST in late 1986 and is being maintained
  165.     by David Parsons (orc) of Minneapolis, MN.  Other people
  166.     that have had a hand in Citadel/Citadel-86/STadel are Jay
  167.     Johnson, who ported Citadel-86 to the Amiga in fall '86,
  168.     Christopher Robin, who did extensive work with Citadel at
  169.     around the same time, Dale Schumacher, who provided quite a
  170.     few suggestions, practical and impractical, John Stanley,
  171.     who helped with the initial port of Citadel to Citadel-86,
  172.     and probably many other people I can't remember.
  173.  
  174.                 -david parsons
  175.                 -orc
  176.  
  177.     See Also
  178.     MANAGER.DOC
  179.     TUTORIAL.DOC
  180.     NETWORK.DOC
  181.  
  182.     Advertisement
  183.  
  184.     "Like all begware, STadel will whine for money"
  185.